8bitfiles.net/archives

home *** CD-ROM | disk | FTP | other *** search

/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 01 New Uploads / WSDOS-50.SDA / WS DOS.DOC < prev

Wrap

Text File | 2019-04-13 | 21.7 KB | 466 lines

─OCUMENTATION, VERSION 5.0 OF ╫╙ ─╧╙ ╘UESDAY, ╩UNE 9,1998 ╫╙ ─╧╙ (├)1992,93,94,95,98 ╫╙OFT ╞╥┼┼╫┴╥┼- ├OPY ╙HARE ╨OST ─ON'T ╙ELL ╨╥┼╞┴├┼ ╫ELL THAT ABOUT DOES IT. ╔'M READY TO RELEASE THIS LATEST VERSION (5.0!) OF ╫╙ ─╧╙. ╬OT ONLY HAVE NIFTY NEW FEATURES BEEN ADDED, COMPATIBILITY WITH THE ╥┴═LINK HAS ALSO BEEN GREATLY IMPROVED OVER VERSION 4.1, WHICH HAD PROBLEMS SWITCHING DOWN TO 64-MODE UNLESS THE ╥╠ WAS SWAPPED WITH ANOTHER DEVICE. ╫ITH THIS NEWER VERSION, YOU SHOULD BE ABLE TO BOOT WITH THE ╥┴═LINK IN (OR OUT OF) A SWAPPED STATE. ╚OWEVER, THERE ARE DIFFERENT ╥╧═ VERSIONS LURKING AROUND OUT THERE, SO ╔ CAN ONLY VOUCH THAT EVERYTHING WORKS FINE WITH MINE, AND WISH YOU THE SAME WITH YOURS. ╞OR THE BENEFIT OF THOSE OF YOU USING THIS SOFTWARE FOR THE FIRST TIME, ╫╙ ─╧╙ WAS CONCIEVED FROM THE FIRST MOMENT ON WITH THE STOCK 128-USER IN MIND. ╒TILIZING THE HIGHER BURSTMODE CAPACITY OF THE 1571 AND 1581 DISK DRIVES TO BOOT UP 64-MODE SOFTWARE HAS BEEN DONE MANY TIMES BEFORE, IN VARIOUS WAYS. ╘HE 64 "BOOT DISKS" AND OTHER "STAND ALONE"-TYPE PROGRAMS COME TO MIND. ┘ET MANY OF THESE PROGRAMS SHARED ONE DISADVANTAGE- YOU EITHER HAD TO RELOAD THE SOFTWARE WHICH PERFORMED THIS TASK EACH TIME YOU NEEDED IT, OR HAD TO PREPARE A DISK BOOT SECTOR (FOR BOOTING ╧╬┼ PROGRAM), ETC. ╫╙ ─╧╙ DOES'NT FALL INTO EITHER CATEGORY. ╧NCE YOU'VE BOOTED IT, IT TAKES RESIDENCE IN THE BANK 1 WHERE A 64 MODE PROGRAM CAN'T DISTURB IT. ┴LL IT TAKES TO GET BACK INTO THE PROGRAM IS TO ENTER 128 MODE AS YOU NORMALLY WOULD BY PRESSING THE RESET BUTTON. ╘HE COMMANDS ARE SIMPLE... ANYONE WHO HAS USED ├OMMODORE'S ─╧╙ ╫┼─╟┼ (OR ╩IFFYDOS) WILL SEE THE SIMILARITY IN ╫╙ ─╧╙. ┴ BUG HAS BEEN FIXED IN REGARD TO LOADING PROGRAMS FROM THE OLDER ╨┼╘ AND ├┬═ COMPUTERS. ╔F ╫╙ ─╧╙ FINDS A LOW BYTE OF 0 IN THE ADDRESS MARK OF THE FILE TO BE BOOTED, IT WILL ASSUME THAT IT IS DEALING WITH A PROGRAM FROM ONE OF THOSE OLDER MONSTERS AND COPY THE FILE TO $0800, REGARDLESS OF WHAT IS CONTAINED IN THE HIGH BYTE (FOR ╨┼╘S AND ├┬═S ╔ BELIEVE THIS WOULD BE 4). ╔F YOU HAVE ANY COMMENTS ON THE PROGRAM, OR AN IDEA REGARDING A NEW FEATURE, PLEASE CONTACT ME AT THE FOLLOWING ADDRESS. ╙ID ─AVIS 1706 ┬RONSON ┴VE. ═ODESTO, ├┴. 95350 ------------------------------------------------------------------------------ ╬┼╫ ╞┼┴╘╒╥┼╙ IN ╫╙ ─╧╙ 5.0 1) ╥┴═LINK ├OMPATIBILITY ╟OOD ╘O SUM IT UP IN A FEW WORDS, THIS VERSION OF ╫╙ ─╧╙ GETS ALONG WITH (MY) ╥┴═LINK BETTER THAN ANY PROGRAM OF IT'S TYPE ╔'VE SEEN AS YET. ┬OOTING A 64 PROGRAM FROM 128-MODE IS NOW EXACTLY AS EASY AS IT ALWAYS HAS BEEN WHEN USING ╩IFFYDOS. ╫HEN YOU LOAD OR BOOT A 64 PROGRAM, THE PARTITION NUMBER AND THE SWAP BUTTONS REMAIN UNCHANGED AFTER THE 64 MODE SWITCH TAKES PLACE. ╘O BE FRANK, ╔'VE GIVEN UP TRYING TO FIND ANY MORE BUGS IN THE ╥┴═LINK FIX. ╘HE COMPATIBILITY IS THAT GOOD. ╔ WILL ASSUME THAT BY USING THE ADDRESS $E0A9 TO DETECT THE PRESENCE OF A ╥┴═LINK, THAT ╨┴╠ ╥╠ USERS MAY ALSO USE ╫╙ ─╧╙. ┴T $E0A9 IS A ROUTINE WHICH SWITCHES IN ╥╠ SYSTEM MEMORY, AND IT HAS BEEN WELL DOCUMENTED IN THE ╥┴═LINK OPERATING MANUALS AS EARLY AS 1991 (TO THE BEST OF MY KNOWLEDGE). 2) ═ULTIPLE ─RIVE ╙UPPORT IN A ╨├ ┼NVIRONMENT ┴S YOU MIGHT HAVE ALREADY GUESSED, ╫╙ ─╧╙ IS NO LONGER LIMITED TO DEVICES 8 AND 9. ╓ERSION 5.0 SUPPORTS DEVICES IN THE RANGE OF 8-31. ╘HE PROMPT IS NO LONGER NUMERIC- THE DRIVE DESIGNATION IS NOW HANDLED MUCH LIKE ├╨/═ OR ═╙ ─╧╙, WHERE "┴:" IS THE FIRST FLOPPY (DEVICE 8 ON THE BUS) "┬:" IS DEVICE 9, "├:" IS DEVICE 10, ETC. ╘HIS WOULD MAKE THE ╥┴═LINK DEVICE "╔:", BUT YOU COULD ALWAYS CHANGE THAT TO A DRIVE "─:", AND YOUR HARD DRIVE TO DRIVE "├:", IF YOU WANT THE ╨├ FEEL. ╔'VE SET MINE UP LIKE THAT, AND USE DEVICE NUMBERS OF "┴:" AND "┬:" FOR MY 1571 AND 81 DISK DRIVES. ╘O LOG IN A DIFFERENT DRIVE, ENTER THE LETTER DESIGNATOR AND TRAIL IT WITH A COLON ":". ╫╙ ─╧╙ WILL MAKE SURE THAT THE REQUESTED DEVICE NUMBER FALLS WITHIN THE LEGAL RANGE OF 8-31 (┴ TO ╪), AND INSURE THAT THE DRIVE IS ON. ╞OR EXAMPLE, IF YOU ENTERED; ┴>D: (LOG REQUEST ON DEVICE 11) OR ┴>─: (NOT CASE SENSITIVE) 00, OK,00,00 (YOUR REPORT, PROVIDED THE DRIVE IS ON) ─> <--- DRIVE ─ IS NOW LOGGED IN. 3) ╘ARGET ─RIVE ╙ELECTION FOR THE ╞ILECOPY ╞UNCTION ╔F YOU'VE EVER USED ╫╙ ─╧╙ 4.1, YOU'LL KNOW THAT SELECTING THE TARGET DRIVE WAS AS SIMPLE AS BINARY 0 AND 1. ╙INCE ONLY DEVICES 8 AND 9 WERE SUPPORTED ANYWAY, THE ONLY DEVICE WHICH *COULD* BE THE TARGET DRIVE WAS ALWAYS THE ONE NOT LOGGED AT THE PROMPT (THE SLEEPER). ╫ITH THE ADDITION OF MULTIPLE DRIVE SUPPORT IN 5.0 HOWEVER, SOME CHANGES WERE MADE. ╞IRST, ╔ RID ╫╙ ─╧╙ OF THE #8 "TOGGLE" PRINCIPLE. ┴DDING THE MULTIPLE SUPPORT RENDERED IT PRETTY WELL OBSOLETE. ╘HE "#" IS STILL USED AS A COMMAND, BUT NOW IT'S USED AS A "TARGET DEVICE" SELECTOR FOR THE FILE COPY COMMAND. ╘O SELECT A DRIVE TO COPY TO, CHECK FIRST THAT THE DRIVE IS ON, OR YOU'LL GET AN ERROR. ╙IMPLY ENTER THE COMMAND "#", FOLLOWED BY THE DRIVE DESIGNATOR AND A COLON. ┼XAMPLE; ┴>#E: (REQUEST ON DEVICE 12 AS TARGET DRIVE) ╘ARGET ─EVICE ╙ET <--- YOUR REPORT, IF EVERYTHING WENT OK ┴> ╘HE SOURCE DRIVE REMAINS THE CURRENTLY ACTIVE, OR "LOGGED" DEVICE. ╔N THE EXAMPLE ABOVE, THIS WOULD BE DEVICE 8 (OR "┴:"). 4) ╘HE "\" ├OMMAND: ╥EAD ╨┼╘┴╙├╔╔ TEXT FILES ╘HIS ONE MAY LATER BE IMPROVED TO READ ┴╙├╔╔ FILES AS WELL, BUT FOR THE TIME BEING IT WILL DO. ╥EADS ╙┼╤, ╨╥╟, OR ╒╙╥ TEXTFILES (A HANDY GADGET). ╫E ╥┴═LINK USERS ARE QUITE SPOILED BY THE ABILITY TO READ A TEXTFILE ON THE FLY. ╔'VE ADDED THIS NEW FEATURE AS ONE OF CONVENIENCE FOR YOU STOCK 128 USERS. ╙INCE ╫╙ ─╧╙ CAN POP UP ANYTIME AT THE TOUCH OF THE RESET BUTTON AND INSTANTLY BE THERE, IT'S HANDY TO ENTER 128-MODE, READ THE DOC FILE OF A PROGRAM, AND REBOOT YOUR SOFTWARE. ╬O MORE WASTING TIME SEARCHING FOR THAT (SLOW) FILE READER PROGRAM. 5) "─╧╙" ├OMMANDS ON THE 128 ╫╙ ─╧╙ HAS BEEN "ADDED ON" TO GIVE THE EXPERIENCED ═╠ PROGRAMMERS AMONG US THEIR OWN "WEDGE" INTO THE SYSTEM. ╔F YOU CAN PROGRAM IN MACHINE CODE, THEN YOU MAY WANT TO ADD SOME NEW COMMAND TO THE PALLETTE. ╞OR THIS REASON, THE "SYNTAX" ERROR IS NO MORE. ┴S FAR AS ╫╙ ─╧╙ IS CONCERNED, ANYTHING YOU ENTER AT THE PROMPT CAN BE A VALID COMMAND ON DISK. ╔F THE WORD YOU TYPED IS A VALID FILE ON DISK, THEN THE FILE IS CHECKED FOR A CERTIAN SEQUENCE OF BYTES. ╘HIS ╨┼╘┴╙├╔╔ TEXT -> WSDOS98 <-- IS USED AS AN INDENTIFYING HEADER. ╔F THESE BYTES ARE PRESENT, THE FOLLOWING 2 BYTES ARE USED AS AN INDIRECT POINTER AND ╫╙ ─╧╙ TRANFERS TOTAL CONTROL TO YOUR CODE, WHICH YOU MUST ASSEMBLE TO $3000. ╫╙ ─╧╙ WILL SHOVE A RETURN ADDRESS ONTO THE STACK BEFORE THE JUMP OCCURS, SO ALL YOUR CODE MUST DO TO RETURN TO THE PROGRAM IS TO TERMINATE WITH AN ╥╘╙. ╔ HAVE MADE ABOUT TEN OR ELEVEN SUCH "─╧╙" COMMANDS AS A RESULT OF BETA-TESTING. ┘OUR CODE NEED NOT INCLUDE A CARRIAGE RETURN AFTER OUTPUTTING TO THE SCREEN, THAT IS TAKEN CARE OF AFTER YOU ╥╘╙ BACK TO THE PROGRAM. ╘HE ONLY THING THAT'S IMPORTANT IS THAT ╫╙ ─╧╙ CAN PROPERLY IDENTIFY THE FILE, WHICH MUST CONTAIN THE PROPER HEADER ╔─ AND THE ADDRESS MARK OF $3000. ╔F YOU'VE SET THAT UP CORRECTLY, THE JUMP OVER POINTER $3007+8 WILL OCCUR. ╘HERE ARE A FEW ROUTINES ALREADY IN ╫╙ ─╧╙ THAT YOU MAY FIND HANDY. ┴T $2FEE THERE IS A SMALL JUMP TABLE WHICH PROVIDES EASY ACCESS TO 6 OF THEM. ╔╬╘┼╥╞┴├╔╬╟ ╫╔╘╚ ╫╙ ─╧╙ $2FEE JMP ╓┴╠╔─ ╓┴╠╔─ IS A ROUTINE WHICH VERIFIES THE EXISTANCE OF A FILE, STORES IT'S ADDRESS MARK TO $FB AND $FC, AND RETURNS TO THE CALLING ROUTINE (PROVIDED THE FILE EXISTS). ┴NYTIME ╫╙ ─╧╙ WORKS WITH A FILE ON DISK, IT CALLS THIS ROUTINE FIRST TO WEED OUT ANY POSSIBLE "FILE NOT FOUND" ERROR. ╔F THE FILE DOES NOT EXIST, 2 BYTES ARE PULLED FROM THE STACK AND ╫╙ ─╧╙ RESUMES NORMAL OPERATION. ┬EFORE CALLING THIS ROUTINE, STORE THE FILENAME AT $1602, AND THE FILE LENGTH (PLUS 1) AT $1600. $1601 IS WHERE THE COMMAND CHARACTER IS STORED WITHIN THE INPUT BUFFER, WHICH ADDS ONE VALUE TO THE LENGTH IN $1600. ╙O REMEMBER: ╘HE FILENAME LENGTH (+1) IN $1600, AND STASH THE FILENAME AT $1602. ╔F YOU'VE SET THAT UP RIGHT, ╓┴╠╔─ WILL HANDLE THE LENGTH AND THE LOCATION OF THE FILENAME CORRECTLY. ╔F YOU WISH TO READ THE ERROR CHANNEL AFTER CALLING THIS ROUTINE, JUMP TO ╞╒╠╠┼╥╥ AT $2C91. ╞╒╠╠┼╥╥ WILL PROPERLY HANDLE THE ERROR OUTPUT AFTER A CALL TO ╓┴╠╔─, WITHOUT A RETURN TO THE CALLING ROUTINE. ╞╒╠╠┼╥╥ WILL POP THE STACK TWICE AND OUTPUT THE ERROR. ╚OWEVER, ╓┴╠╔─ WILL CALL ╞╒╠╠┼╥╥ IF IT ENCOUNTERS AN ERROR, AND PROGRAM EXECUTION IS RESUMED BY ╫╙ ─╧╙. ╧THERWISE, IF EVERYTHING WENT ╧╦, IT WILL DO AN ╥╘╙ BACK TO YOUR ROUTINE. ╓┴╠╔─ WILL FILTER ANY POSSIBLE DISK ERROR BY OPENING THE FILE ON DISK, AND READING THE FIRST BYTE OF THE ERROR CHANNEL. ╔F THIS BYTE IS ANYTHING OTHER THAN $30 (FIRST BYTE OF AN "00, OK, 00,00" STRING), THEN ╞╒╠╠┼╥╥ IS CALLED TO OUTPUT THE REMAINDER OF THE ERROR TO THE SCREEN. ┴LWAYS USE A ╩╙╥ TO CALL THIS ROUTINE. $2FF1 JMP ┬╧╧╘ ╘HIS ROUTINE WILL CALL ╓┴╠╔─ TO CONFIRM THE EXISTANCE OF A FILE, AND THEN BOOT IT INTO 64-MODE. ╙ET UP JUST LIKE YOU WOULD FOR THE ╓┴╠╔─ ROUTINE. ╔N THE EVENT OF AN ERROR, THE OPERATION IS ABORTED AND ╫╙ ─╧╙ RESUMES CONTROL. $2FF4 JMP ╠╧┴─ ╘HIS WILL DO THE SAME AS THE ┬╧╧╘ ROUTINE, WITH ONE EXCEPTION AND ONE EXTRA- ╔T WILL NOT START THE PROGRAM; IT BAILS TO DIRECT MODE AFTER IT HAS FINISHED SETTING UP THE 64. ╔F YOU HAVE THE ├╧╬╘╥╠ KEY DOWN DURING THE LOAD, THE PROGRAM WILL BE ╠╔╙╘ED AS WELL. ╙ETTING UP IS DONE THE SAME WAY AS FOR THE ╓┴╠╔─ AND ┬╧╧╘ ROUTINES. $2FF7 JMP ├╚╦─╙╦ ╘HIS POWERFUL ROUTINE IS THE ONE WHICH MAKES USING "─╧╙" COMMANDS POSSIBLE, AND COULD BE USED TO CHAIN ─╧╙ COMMANDS TOGETHER. ╘HIS COULD BE DONE IN THIS WAY: ─╧╙ COMMAND "╪" IS CALLED, COPIES ITELF ELSEWHERE IN MEMORY AND RESUMES CONTROL AT THE NEW MEMORY LOCATION, LEAVING MEMORY AT $3000 FREE FOR MORE ─╧╙ COMMANDS. ─╧╙ COMMAND "╪" THEN SETS THE FILENAME UP WITH THE ┴├╘╒┴╠ NUMBER OF CHARACTERS IN ─╧╙ COMMAND "┘"S FILENAME, AND STORING THE FILENAME TEXT TO $1601 (NOT $1602). ─╧╙ COMMAND "╪" THEN MODIFIES THE EXISTING RETURN ADDRESS WITHIN THE ├╚╦─╙╦ ROUTINE TO (LATER) SIMILATE AN ╥╘╙ TO ITSELF, AND THEN THE ├╚╦─╙╦ ROUTINE IS CALLED. ─╧╙ COMMAND "┘" EXECUTES ITSELF AND ENDS WITH AN ╥╘╙, WHICH RETURNS CONTROL TO ─╧╙ COMMAND "╪" ONCE AGAIN (WHICH CALLS ─╧╙ COMMAND "┌", ETC). ├ARE SHOULD BE TAKEN TO RESTORE THE ORIGINAL RETURN VALUES INTO ├╚╦─╙╦ TO INSURE THE ROUTINE WILL WORK CORRECTLY (IF YOU STILL INTEND TO USE THE ─╧╙). ╘HIS COULD BE DONE ON THE FLY BY PULLING THE FIRST BYTE FROM THE STACK, STASHING IT INTO ANOTHER REGISTER, PULLING THE SECOND, RESTORING THE ├╚╦─╙╦ ROUTINE WITH THESE VALUES, AND ENDING YOUR CODE WITH A DIRECT ╩═╨ TO $202B, WHERE ╫╙ ─╧╙ OUTPUTS A NEW INSTANCE OF THE PROMPT AND WAITS. ╔N FACT, IF YOU INTEND TO DO SUCH THINGS AS CHAINING ─╧╙ COMMANDS TOGETHER, IT MIGHT BE BEST TO PULL THE RETURN ADDRESS FROM THE STACK RIGHT OFF THE BAT, BEFORE ANYTHING ELSE IS DONE. ╔N THIS WAY, YOU NEED NOT CONCERN YOURSELF WITH THE STACK REQUIREMENT AS MUCH, AND YOU CAN END YOUR CODE WITH A JUMP TO $202B. ╘HE LOCATIONS WHERE THE LOW AND HIGH BYTES EXIST WITHIN ├╚╦─╙╦ ARE $2E3E (LOW) AND $2E38 (HIGH), RESPECTIVELY. ╘HESE LOCATIONS USUALLY CONTAIN THE VALUES $2A AND $20, SETTING UP AN EVENTUAL (╥╘╙) RETURN TO ADDRESS $202B. ╫HEN PUSHING A RETURN ADDRESS ONTO THE STACK, INSURE THAT YOU FIRST PUSH THE HIGH, THEN THE LOW BYTE (-1) OF THE POINT IN MEMORY YOU WISH THE NEXT ╥╘╙ TO RETURN TO. ╘HE POSSIBILITIES OF THIS ROUTINE ARE ENORMOUS. ╔ MAY EVEN ATTEMPT TO PROGRAM A MULTIPLE FILE-COPIER USING THIS TECHNIQUE (JUST AN IDEA). ┴S WITH ╓┴╠╔─, THIS ROUTINE SHOULD BE CALLED WITH A ╩╙╥ INSTRUCTION. $2FFA JMP ├╚╦╨╥╙ ╘HE ├╚╦╨╥╙ ROUTINE WILL TELL YOU WHETHER A DRIVE IS POWERED UP. ╙ET UP BY SAVING THE ACTUAL NUMBER STORED IN $BA, LOAD THE DEVICE NUMBER THAT YOU WISH TO TEST INTO REGISTER ┴, AND CALL THIS ROUTINE. ╔F THE DRIVE IS NOT ON, THE ROUTINE WILL RETURN WITH THE NEGATIVE FLAG SET, AND A BRANCH WITH ┬═╔ COULD BEND TO YOUR OWN ERROR HANDLER. ╥EMEMBER TO RESTORE THE OLD VALUE INTO $BA BEFORE RETURNING CONTROL TO ╫╙ ─╧╙, TO INSURE THAT THE "LOGGED" DEVICE WILL REMAIN UNCHANGED. ╔F THE TEST WAS A FAILURE, ONE OPTION WOULD BE TO POP THE STACK TWICE, RESTORE $BA AND JUMP TO THE ╬╧─┼╓ ROUTINE AT $24A3, WHICH WILL OUTPUT THE MESSAGE "─EVICE NOT PRESENT". ╘HEN YOU ARE AT THE PROMPT, WHERE THE USER WILL HAVE A CHANCE TO CORRECT THE PROBLEM (ON/OFF SWITCH) AND TRY AGAIN. $2FFD JMP ┼╥╥╧╥ ╘HIS ROUTINE IS THE ONE WHICH OUTPUTS THE ERROR CHANNEL OF THE CURRENTLY LOGGED DISK DRIVE. ┬E AWARE THAT THERE IS NO RETURN FROM THIS ROUTINE, SO YOUR CODE SHOULD PULL THE 2 ╥╘╙ BYTES FROM THE STACK BEFORE CALLING IT. ╧THER USEFUL LOCATIONS ASIDE FROM THESE AND THE ╬╧─┼╓ ROUTINE ARE; ╚┼╪╧╒╘ ($2AA0) ╧UTPUT A NUMBER IN ╚┼╪ FORMAT TO THE SCREEN. ╙TORE A NUMBER FROM 0 TO 255 IN THE ┴ REGISTER, AND CALL THIS ROUTINE. ╨┼┼╨ ($215D) ╦EY CLICK SOUND. ╩╙╥ TO THIS ROUTINE AFTER $╞╞┼4 DETECTS A KEYPRESS, FOR EXAMPLE. ┼╙├┴╨┼ ($2B5A) ┼XITS ╫╙ ─╧╙. ╔F YOU WANT THE PROGRAM TO END, THIS ROUTINE IS THE PROPER ONE TO CALL. ╬O "ARE YOU SURE" MESSAGE. ╙ETS TOP OF MEMORY IN THE BANK 1 TO $E800. ╘URNS ON ╩IFFYDOS, OUTPUTS ├128 STARTUP SCREEN, AND RESTORES FUNCTION KEY VALUES (AMONG OTHER THINGS). ------------------------------------------------------------------------------ ╧╠─ ┴╬─ ╬┼╫ ╫┴╥═┼─ ╧╓┼╥ ┘OU MAY STILL USE ALL OF THE OLDER COMMANDS FROM PREVIOUS VERSIONS. ╚ERE IS A LIST OF ALL OF THE COMMANDS, WHAT THEY DO, AND HOW TO USE THEM. 1) ╘HE DOLLAR SIGN "$". -─ISPLAYS THE ─IRECTORY ╘HIS COMMAND WILL DISPLAY THE DIRECTORY OF THE LOGGED DISK DRIVE. ╨ATTERN MATCHING IS FULLY SUPPORTED. ┼XAMPLE; ┴>$0:WS* ╘HIS WOULD DISPLAY A DIRECTORY LISTING OF ALL FILES ON DRIVE ┴: WHICH BEGIN WITH "WS". 2) ╘HE SLASH "/". -╠OADS/╠ISTS A ╨ROGRAM ┼NTER THIS COMMAND BEFORE THE FILENAME OF THE 64 MODE FILE YOU WISH TO LOAD. ╘HIS LOAD WILL NOT TERMINATE BY ╥╒╬NING THE FILE, BUT IT WILL CHECK TO SEE IF YOU ARE PRESSING THE ├╧╬╘╥╧╠ KEY. ╔F YOU ARE, YOU WILL BE SHOWN A ╠╔╙╘ING OF THE FILE'S CONTENTS UPON COMPLETION OF THE LOAD. ╧THERWISE ALL YOU'LL SEE IS THE ├64 STARTUP SCREEN AND A BLINKING CURSOR. 3) ╘HE ARROW UP "^". -┬OOTS A ╨ROGRAM ╘HIS COMMAND WILL LOAD A FILE IN 128-MODE, AND ╥╒╬ IT IN 64 MODE. ┼NTER THE COMMAND, FOLLOWED BY THE FILENAME OF THE PROGRAM YOU WISH TO BOOT. ┘OU'LL NOTE THAT THE STARTUP SCREEN IN 64 MODE WILL REFLECT THE REMAINING NUMBER OF BYTES FREE. 4) ╘HE QUESTION MARK "?". -╞INDS THE ┴DDRESS ═ARK OF A ╞ILE ═ANY TIMES ONE CANNOT BE SURE IF THAT FILE REALLY WILL START WITH ╥╒╬, OR IN WHICH MODE IT WAS MEANT TO BE USED. ╠UCKILY, THE FIRST 2 BYTES OF A FILE CONTAIN THE INFORMATION WE NEED. ╘HIS IS THE "ADDRESS MARK" REFERRED TO IN AN EARLIER PORTION OF THIS DOC. ╔F YOU HAVE DOUBTS ABOUT A PROGRAM, TYPE IN A QUESTION MARK AND FOLLOW IT (NO SPACES BETWEEN ANY ╫╙ ─╧╙ COMMANDS AND THE FILENAMES) IMMEDIATELY WITH THE FILENAME. ┴FTER PRESSING RETURN, YOU WILL SEE THE DECIMAL AND HEXIDECIMAL START ADDRESS OF THAT FILE. ═OST 64 PROGRAMS WHICH START WITH ╥╒╬ BEGIN AT 2049, OR $0801. ╔F THIS IS THE CASE, THEN YOU'LL SEE "╧K" APPEAR DIRECTLY TO THE RIGHT OF THE NUMBER 2049. ╔F YOU SEE THIS, THE PROGRAM SHOULD BE EXECUTABLE WITH ╥╒╬. ╧LDER ╨┼╘ AND ├┬═ PROGRAMS USUALLY HAVE 1024 ($0400) AS AN ADDRESS MARK. ╫╙ ─╧╙ CAN HANDLE THESE TYPES OF FILES NOW AS WELL, THAT BUG HAS BEEN PERMANENTLY SQUASHED. 5) ╘HE ┴╘ SIGN "@". -╥EADS ┼RROR ├HANNEL/╙ENDS ─ISK ├OMMAND ╘HIS COMMAND PERFORMS A DUAL FUNCTION. ╫HEN ENTERED ALONE, IT WILL READ THE ERROR CHANNEL OF THE LOGGED DRIVE. ╔T IS ALSO USED TO SEND DISK COMMANDS. ╔F YOU WANTED TO INITIALIZE THE DISK FOR EXAMPLE, YOU COULD ENTER ┬>@I0: ╘HIS WOULD INITIALIZE THE DISK IN DRIVE 9. 6) ╘HE NUMBERS SIGN "#". -╙ELECTS ╘ARGET ─RIVE ╘HIS COMMAND NOW SELECTS THE DRIVE TO BE USED AS THE RECIPIENT OF A FILE WHEN USING THE ├╧╨┘ COMMAND. ┼NTER "#┬:" (OR PRESS ╞8) TO SET UP THE TARGET DRIVE AS 9. ╔F THE DRIVE IS NOT ON, A "─EVICE NOT PRESENT" ERROR OCCURS. 7) ╘HE PERCENT SIGN "%". -┼DITS/─ISPLAYS ┴UTOBOOT ─ATA ╘HIS COMMAND, LIKE THE ERROR COMMAND, ALSO PERFORMS A DUAL FUNCTION. ╫HEN ENTERED ALONE, IT WILL DISPLAY ANY CURRENT AUTOBOOT DATA TO THE SCREEN. ╔T ALSO ALLOWS YOU TO EDIT THIS INFORMATION. ╞IRST OF ALL, LET ME EXPLAIN WHAT ╔ MEAN WHEN ╔ SAY "AUTOBOOT DATA" FOR THOSE OF YOU HAVE NEVER USED ╫╙ ─╧╙ BEFORE. ╫╙ ─╧╙ HAS THE ABILITY TO BOOT ONE OF A POSSIBLE TEN FILES EVERY TIME YOU PRESS THE RESET BUTTON. ┴LL YOU MUST DO IS PRESS ONE OF THE NUMBER KEYS. ╔F YOU HAVE EDITED AND SAVED AN AUTOBOOT FILE TO DISK, THEN ╫╙ ─╧╙ WILL BOOT A FILE INTO 64-MODE, SAVING YOU THE TROUBLE OF TYPING IN THE FILENAME ENTIRELY! ╚ERE'S HOW TO EDIT YOUR OWN "AUTOBOOT" DATA FILE. ┴T THE PROMPT, FOLLOW THE PERCENT SIGN "%" WITH A NUMBER RANGING FROM 0 TO 9, A COLON ":", AND FINISH BY ENTERING THE FILENAME IN QUESTION. ╘HAT WOULD LOOK LIKE THIS: ┴>%0:MYPROG ╬O ERROR OR "╧╦" IS GIVEN OUT AFTER EDITING A KEY. ╘HAT'S NORMAL, NOTHING SHOWS UP LIKE THAT WHEN YOU EDIT IN BASIC EITHER, SO ╔ LEFT IT THAT WAY. ╔ DID'NT INCLUDE A WAY TO DELETE AN ENTRY- BUT YOU CAN GET AROUND THIS BY HAVING AN EMPTY "%" FILE ON HAND SOMEWHERE. ┴FTER LOADING AN EMPTY FILE, ANY AUTOBOOT DATA IS DELETED. ╘AKE THAT, YOU TYPO. 8) ╘HE ARROW LEFT "_". -╙AVES ┴UTOBOOT ─ATA TO ─ISK ╘HIS COMMAND IS ALWAYS ENTERED ALONE. ┴FTER USING THE "%" COMMAND TO EDIT ALL OF YOUR DATA, ENTER THIS COMMAND TO SAVE THE AUTOBOOT FILE TO DISK. ╔N THE DIRECTORY, THE FILE TAKES ON A FILENAME OF "%". ╫HEN YOU PRESS THE RESET KEY, ╫╙ ─╧╙ WILL LOOK FOR THIS FILE. ╔F IT'S THERE, IT WILL BE LOADED INTO MEMORY AND THEN THE KEYBOARD IS CHECKED. ╔F ANY OF THE NUMBER KEYS ARE BEING PRESSED AT THIS TIME, THE FILENAME WHICH APPEARS NEXT TO THAT NUMBER IN YOUR DATA FILE WILL BE BOOTED INTO 64 MODE AUTOMATICALLY. 9) ╘HE EXCLAMATION MARK "!". -╠OADS/─ISPLAYS ┴UTOBOOT ─ATA ╘HIS COMMAND IS ALWAYS ENTERED ALONE AS WELL. ╔F THE DISK YOU JUST INSERTED IN THE LOGGED DRIVE CONTAINS AN AUTOBOOT FILE, ENTER THIS COMMAND TO LOAD IT INTO MEMORY AND ╫╙ ─╧╙ WILL OUTPUT ITS DATA TO THE SCREEN. 10) ╘HE ASTERIX "*". -├OPYS A ╞ILE TO THE ╘ARGET ─EVICE ╘HIS IS THE FILE COPIER. ┬EFORE YOU CAN COPY A FILE, YOU MUST FIRST SELECT A DRIVE TO COPY TO WITH THE "#" COMMAND (AS EXPLAINED EARLIER). ╞OLLOW THE COMMAND WITH THE FILENAME OF THE FILE YOU WISH TO COPY. 11) ╘HE ╠IRA SYMBOL "\". -╥EADS ╘EXTFILES ╒SE THIS COMMAND TO READ ╨┼╘┴╙├╔╔ TEXT FILES OF TYPES ╙┼╤, ╨╥╟ OR ╒╙╥. 80 COLUMN MODE IS HIGHLY RECOMMENDED. ┴GAIN, ENTER THE COMMAND FOLLOWED BY THE FILENAME OF THE TEXTFILE YOU WISH TO READ. ╒SE THE ╬╧ ╙├╥╧╠╠ KEY TO STOP THE SCREEN FROM SCROLLING UP. ╨RESS IT AGAIN TO RESUME. ┴BORT WITH THE ╙╘╧╨ KEY. 12) ╘HE LETTER "X". -┼SCAPE ╫╙ ─╧╙ ╘HIS WAS INCLUDED FOR THOSE OF US WHO CAN'T FIND THIER WAY OUT OF A WET PAPER BAG UNLESS THEY PRESS THE "X" BUTTON (LIKE MYSELF). ╔T IS MERELY ANOTHER WAY TO EXIT ╫╙ ─╧╙. ╔ THINK ╔ SPENT TOO MUCH TIME IN THE MONITOR BACK IN THOSE DAYS. 13) ╘HE ╚┼╠╨ COMMAND -─ISPLAYS A ╚ELP ╙CREEN ┘OU MAY EITHER PRESS THE ╚┼╠╨ KEY, OR ENTER THE WORD ╚┼╠╨ AT THE PROMPT. ┘OU WILL BE PRESENTED WITH A ONE PAGE ╚┼╠╨ SCREEN, WHERE A SHORT LIST OF ALL ╫╙ ─╧╙ COMMANDS AND KEY DEFINITIONS CAN BE VIEWED FOR QUICK REFERENCE PURPOSES. ─╧╙ ├╧══┴╬─╙ ╙╒╨╨╠╔┼─ ╫╔╘╚ ╫╙ ─╧╙ ┴S ╔ MENTIONED EARLIER ON, ╔ HAVE MADE SEVERAL ─╧╙ COMMANDS ALREADY. ╚ERE IS A BRIEF DESCRIPTION OF WHAT THEY DO. ┴LTHOUGH ╔ HAVE MADE MORE THAN THESE, ╔ DID'NT THINK THE OTHERS WERE USEFUL ENOUGH TO INCLUDE IN THE ARCHIVE. ╚ERE ARE 5 OF THEM, WHICH MOSTLY HAVE SOMETHING TO DO WITH THE ╓─├ CHIP. 1) ╙═┴╠╠ ╘HIS COMMAND WILL SHRINK THE ╓─├ DISPLAY TO HALF IT'S SIZE WHILE KEEPING A READABLE 80╪25. ╫HEN ╙═┴╠╠ EXECUTES, IT COPYS ITSELF INTO $0C00 (BLOCK 12), AND SETS UP THE ╥╒╬/╙╘╧╨-╥┼╙╘╧╥┼ VECTOR AT $0A00+01 TO POINT TO ITSELF. ╚OWEVER IF YOU EXIT ╫╙ ─╧╙, THIS POINTER IS OVERWRITTEN. ╔T CAN BE REINITIALIZED FROM ┬ASIC 7.0 WITH ╙┘╙ 3072. 2) ╙╔┌┼ ╘HIS WILL TOGGLE BETWEEN 40 AND 80 COLUMN MODES, TOGGLING ╞┴╙╘ MODE ON AND OFF WHERE APPROPRIATE. 3) ╥╔╟╚╘ ┼NTERING THIS COMMAND WILL CREATE A WINDOWED AREA ON THE RIGHT SIDE OF THE 80 COLUMN SCREEN WHICH IS 40 COLUMNS WIDE. 4) ╠┼╞╘ ╘HIS WILL DO THE OPPOSITE OF THE ╥╔╟╚╘ COMMAND. 5) ┬╔╟ ╘HIS RESTORES THE WINDOWED AREA OF THE 80 COLUMN SCREEN TO IT'S ORIGINAL (╫╙ ─╧╙) PROPORTIONS OF 80 COLUMNS AND 23 LINES AFTER HAVING USED THE ╠┼╞╘ OR ╥╔╟╚╘ COMMANDS. ------------------------------------------------------------------------------ ╞╔╠┼╙ ╔╬ ╘╚┼ ┴╥├╚╔╓┼ ┴FTER YOU DISSOLVED THIS ARCHIVE, YOU MAY HAVE WONDERED WHAT THE FILE "WS DOS 5.0.RL" WAS FOR. ╘HIS IS A VERSION OF ╫╙ ─╧╙ 5.0 WHICH WILL NOT INSTALL ITSELF INTO THE BANK 1, BUT INSTEAD IS LOADED EACH TIME YOU NEED IT. ╔ INCLUDED THIS FOR THOSE ╥┴═LINK USERS WISHING TO USE THEIR ╥╠ BOOT FEATURE WHEN THEY POWER UP OR HIT THE RESET BUTTON. ╙OME STOCK 128 USERS MAY HAVE THE SAME PREFERENCE WITH THIER BOOT DISKS. ╘HE FILE "WS DOS 5.0" IS THE TRADITIONAL VERSION WHICH COPYS ITSELF INTO THE BANK 1. ╔ HOPE YOU ENJOY THE SOFTWARE! ╙ID (╫╙OFT)